- Click the “Open…” buttons to present a list of stacks on any inserted disk.
- Select from either list the resource or resources you want to copy, remove, rename or renumber.
- If you click on an ‘ICON’, it is displayed in the box in the middle of the window. If you click on a ‘snd ’, the “Play” button is activated. If you click on a ‘CURS’ the cursor is changed to that cursor until you click the mouse again.
- Click the “Copy” button to copy a selected resource(s) in the direction the arrows point. (The original stack is not changed by copying).
- Click the “Remove” button to remove the selected resource(s) from the stack.
- Click the “Edit” menu to select either
“Rename...” or “Renumber...” to rename or renumber the selected resource. (A dialog box will appear prompting you for the new name or number.)
- Click the “Close” buttons to close stacks that you have opened. (A stack must be closed before you can open another one in its place.)
- Click the “Play” button to listen to a selected sound resource. Press Command-Period if you want to stop the sound before it finishes.
- Click the “Help” button for help with ResCopy.
- Click the “Quit” button to exit the ResCopy program and return to HyperCard.
-- part contents for card part 35
----- text -----
DID YOU KNOW...
A) Alternate ways to run ResCopy:
1) Hold the “Command” key and type “M” to display the message box. Type “ResCopy”
(no quotes) in the message box then press [return].
2) From a script without user intervention
(avoiding dialog entirely), invoke ResCopy along with four arguments:
“fromFile” and “toFile” (you can use “the long name of this stack” for the “from stack”, and use the “FileName” XFCN to allow the user to choose the “to stack”)
   b) you can specify a resource by either its name or ID number
   c) if by name the name must be in quotes
   d) if by number the number needn’t be in quotes
   e) If a resource with the given name or number already exists, it is replaced
   f) If an error is encountered, the resource is not copied, a beep is sounded, and the HyperTalk global variable “the result” is set to “Error!” (otherwise it is empty)
   g) Scripted copying can be used on any type of file, not just HyperCard stacks
See the “Install ResCopy in HOME” button in this stack for an example of this method, useful for stacks that need to install resources into other stacks.
B) ResCopy will not open any file that is already open, unless you open it as read-only (see next item).
 
C) The “Open…” button defaults to displaying a list of HyperCard stacks only. Click “All resource files (read only)” in the “Open” dialog to display all resource files. Use this method to look at HyperCard itself, the System file, or any file that contains resources (like applications). These files are opened read-only, meaning that you can copy from them, but you cannot make any changes to them.
 
D) Option-click the “Remove” button to avoid a warning alert.
E) The following command-key shortcuts are available:
      Command-R — “Rename…”
      Command-N — “Renumber…”
      Command-P — “Play”
      Command-? — “Help”
      Command-Q — “Quit”
E) To install ResCopy into another stack (bash copy protection!), copy these resources:
(required)
       XCMD=10000 "ResCopy"
       DITL=10000 "ResCopy"
       DLOG=10000 "ResCopy"
(optional)
       DITL=10001 "RC Help"
       DLOG=10001 "RC Help"
                     
F) If ResCopy finds the its two “Help” resources (see above), it’s “Help” button is highlighted. If it doesn’t find the two resources, the button is disabled. You can tailor ResCopy for individual applications by modifying the text of the “RC Help” DITL using ResEdit.
G) If you wish to switch to another application while running MultiFinder, click the HyperCard icon in the upper right corner of the menu bar, or on larger monitors, click in one of that application’s windows. When you switch back to HyperCard, ResCopy will still be active.
H) • • Messages • •
* “Convert sound to HyperCard format?” - When copying 'snd ' resources, ResCopy will convert the sounds to HyperCard format if they are not already in that format. Click “OK” to do the conversion. Click “Convert all” to avoid further prompts when copying multiple sounds. The sound in the original file is left unchanged.
* “I am missing some of my resources!” - One of the resources listed above as “required” is missing from the current stack and the Home stack.
* “That file cannot be opened.” - There was a problem opening that file.
* “That file is locked or busy.” - ResCopy was unable to add a new resource to a file.
* “That number already exists! Enter another:” - The new number you entered for a resource is already assigned to a resource in that file.
* “Not enough memory to run ResCopy.” - ResCopy checks to see if there is at least 64K of free RAM. You can get this message if the RAM cache is turned up too high, or if you are running InBox™ or TOPS™. Turn off or disable one or more of these, or set the userLevel to 1 or 2 and try again.
* “Not enough memory to play sound.” - Just what it says.
* “Oops, not a playable Hypercard sound.” - This is a ‘type 1’ sound resource that is not a digitized sound, or is in some other way incompatible with HyperCard.
-- part contents for card part 38
----- text -----
Use the scrolling fields to:
1) learn step-by-step how to use ResCopy
and
2) become familiar with alternate ways to run ResCopy, ways to direct one stack to install resources in another stack, special case operations, and the meaning of ResCopy messages to the user.
Click “Save help to a text file…” to place all of the information on this card into a text document for easier reviewing and printing.
